home *** CD-ROM | disk | FTP | other *** search
/ Clickx 115 / Clickx 115.iso / software / tools / windows / tails-i386-0.16.iso / live / filesystem.squashfs / usr / share / pyshared / docs.py < prev    next >
Encoding:
Python Source  |  2010-04-01  |  3.6 KB  |  78 lines
  1.  # ====================================================================
  2.  # Copyright (c) 2004-2010 Open Source Applications Foundation.
  3.  #
  4.  # Permission is hereby granted, free of charge, to any person obtaining a
  5.  # copy of this software and associated documentation files (the "Software"),
  6.  # to deal in the Software without restriction, including without limitation
  7.  # the rights to use, copy, modify, merge, publish, distribute, sublicense,
  8.  # and/or sell copies of the Software, and to permit persons to whom the
  9.  # Software is furnished to do so, subject to the following conditions: 
  10.  #
  11.  # The above copyright notice and this permission notice shall be included
  12.  # in all copies or substantial portions of the Software. 
  13.  #
  14.  # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  15.  # OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16.  # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  17.  # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  18.  # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  19.  # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  20.  # DEALINGS IN THE SOFTWARE.
  21.  # ====================================================================
  22.  
  23. from _icu import *
  24. from _icu import _install__doc__
  25.  
  26.  
  27. _install__doc__(BreakIterator, '''
  28. The BreakIterator class implements methods for finding the location of
  29. boundaries in text.
  30.  
  31. BreakIterator is an abstract base class. Instances of BreakIterator maintain
  32. a current position and scan over text returning the index of characters
  33. where boundaries occur.
  34.  
  35. Line boundary analysis determines where a text string can be broken when
  36. line-wrapping. The mechanism correctly handles punctuation and hyphenated
  37. words.
  38.  
  39. Sentence boundary analysis allows selection with correct interpretation of
  40. periods within numbers and abbreviations, and trailing punctuation marks
  41. such as quotation marks and parentheses.
  42.  
  43. Word boundary analysis is used by search and replace functions, as well as
  44. within text editing applications that allow the user to select words with a
  45. double click. Word selection provides correct interpretation of punctuation
  46. marks within and following words. Characters that are not part of a word,
  47. such as symbols or punctuation marks, have word-breaks on both sides.
  48.  
  49. Character boundary analysis allows users to interact with characters as they
  50. expect to, for example, when moving the cursor through a text
  51. string. Character boundary analysis provides correct navigation of through
  52. character strings, regardless of how the character is stored. For example,
  53. an accented character might be stored as a base character and a diacritical
  54. mark. What users consider to be a character can differ between languages.
  55.  
  56. The text boundary positions are found according to the rules described in
  57. Unicode Standard Annex #29, Text Boundaries, and Unicode Standard Annex #14,
  58. Line Breaking Properties. These are available at
  59. http://www.unicode.org/reports/tr14/ and http://www.unicode.org/reports/tr29/.
  60. ''')
  61.  
  62. _install__doc__(BreakIterator.__init__, '''
  63. BreakIterator is abstract. Use one of the class instantiators:
  64. createWordInstance, createLineInstance, createCharacterInstance,
  65. createSentenceInstance or createTitleInstance.
  66. ''')
  67.  
  68. _install__doc__(BreakIterator.getText, '''
  69. Return the string over the text being analyzed.
  70. ''')
  71.  
  72. _install__doc__(BreakIterator.createLineInstance, '''
  73. Returns an instance of a BreakIterator implementing line breaks. Line breaks
  74. are logically possible line breaks, actual line breaks are usually
  75. determined based on display width. LineBreak is useful for word wrapping
  76. text.
  77. ''')
  78.